home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / pkxarc30.arc / PKXARC30.DOC < prev   
Text File  |  1986-04-06  |  8KB  |  231 lines
  1. PKXARC   FAST!  Archive Extract Utility  Version 3.0  4-05-86   by Phil Katz
  2. Page 1
  3.  
  4.  
  5. Using PKXARC
  6. ------------
  7.  
  8. PKXARC [/r|l|c|p|v|h] [d:path\]ARCfile [d:path\] [[-extfile]...]
  9.  
  10.  
  11.     /r     Replace existing files without query.
  12.     /l     Display program license information.
  13.     /c     Extract file(s) to the console.
  14.     /p     Extract file(s) to the printer.
  15.     /v     Display a verbose listing of the ARChive(s).
  16.     /h     Display help information.
  17.          -Only ONE of the above options r,l,c,p,v,h can
  18.           be specified at one time.
  19.     d:path\  DOS drive and/or path identifier.
  20.     ARCfile  ARChive file name, wildcards *,? ok.
  21.          If no extension is given .ARC is assumed.
  22.     extfile  Name(s) of files to be extracted.  If none are given
  23.          ALL files will be extracted.  Wildcards *,? ok.
  24.  
  25.  
  26. Examples:
  27.  
  28. PKXARC a:* b:
  29.   -Extract all files from all ARChives on drive A: storing extracted
  30.    files on drive B:.
  31.  
  32. PKXARC sigdir1 c:
  33.   -Extract all files from the ARChive SIGDIR1.ARC in the current
  34.    drive & subdirectory storing extracted files on drive C:.
  35.  
  36. PKXARC c:\lotus\tax -*.wks
  37.   -Extract all .WKS files from ARChive C:\LOTUS\TAX.ARC storing
  38.    extracted files in the current drive & subdirectory.
  39.  
  40. PKXARC/r c:\public\* d:\ -*.doc -*.txt
  41.   -Extract all .DOC and .TXT files from all archives in the directory
  42.    C:\PUBLIC storing the extracted files in the root directory of drive D:.
  43.    Overwrite existing files without query.
  44.  
  45. PKXARC/l c:\download\*
  46.   -Display a verbose listing of all ARChives in the directory C:\DOWNLOAD.
  47.  
  48. PKXARC/c utility -*.doc
  49.   -Extract all .DOC files form the ARChive UTILITY displaying extracted
  50.    files on the console.
  51.  
  52. PKXARC/p utility -*.doc
  53.   -Same as above, except extracted files are displayed on the printer.
  54. PKXARC   FAST!  Archive Extract Utility  Version 3.0  4-05-86   by Phil Katz
  55. Page 2
  56.  
  57.  
  58. PKXARC warnings
  59. ---------------
  60.  
  61. Warning!  File YYY already exists!  overwrite (y/n)?
  62.  
  63.   - A file to be extracted from the ARChive already exists on disk.  Answer
  64.     "y"  to  extract  the  file  from  the archive anyway and overwrite the
  65.     existing file, "n" to not extract the file from the  archive.  Use  the
  66.     "/r" command line option to suppress this warning.
  67.  
  68. Unknown packing method for: YYY
  69.   - The  file  is  squeezed  or  encoded  in a unkown way.  The ARChive is
  70.     probably corrupt.
  71.  
  72. Warning!  File YYY fails CRC check
  73.   - The Cyclic Redundancy Check calculation did not match the stored value.
  74.     The file is probably corrupt.
  75.  
  76. XXX is not an archive
  77.   - The ARChive file header does not indicate this is an ARChive file.
  78.  
  79. Archive length error
  80.   - A end of file token was not found for a file within  the  ARChive.  The
  81.     ARChive is corrupt.
  82.  
  83.  
  84. PKXARC errors
  85. -------------
  86.  
  87. PKXARC: can't find XXX
  88.   - The given ARChive filename could not be found.
  89.  
  90. PKXARC: cannot read archive: XXX
  91.   - The ARChive could not be opened.
  92.  
  93. PKXARC: Cannot create: YYY
  94.   - The  output file could not be created.  The output directory is invalid
  95.     or full.
  96.  
  97. PKXARC: File has invalid decode tree
  98.   - The  Huffman  decode  tree  for  the  file is invalid.  The ARChive is
  99.     corrupt.
  100.  
  101. PKXARC: Disk full
  102.   - A write to the output file failed.  The disk is most likely full.
  103.  
  104. PKXARC: Internal table overflow
  105.   - An internal decode table overflowed.  The ARChive is corrupt.
  106. PKXARC   FAST!  Archive Extract Utility  Version 3.0  4-05-86   by Phil Katz
  107. Page 3
  108.  
  109.  
  110. PKXARC history
  111. --------------
  112.  
  113. Soon after the ARChive file format was introduced into the public domain it
  114. became  popular,  and many BBS files were transfered this way.  The ARChive
  115. format is a convenient way to put several files into one and  squeeze  them
  116. for effecient disk storage and reduced transfer time, in one step.
  117.  
  118. However, the ARChive utility was  much  slower  at  extracting  files  than
  119. equivalent  UnSQueeze  type  programs.   In the inevitable quest for faster
  120. ARChive file extraction, PKXARC was created.
  121.  
  122.  
  123. Changes in PKXARC version 2.3
  124. -----------------------------
  125.  
  126. The ability to extract dynamic Lempel-Zev encoded files was added.  Version
  127. 5.0  of  ARC  introduced  a  new,  more  efficient  variation of Lempel-Zev
  128. "Crunching".  PKXARC can now  extract  files  Crunched  with  this  method,
  129. approximately 3 times faster than ARC 5.1.
  130.  
  131.  
  132. Changes in PKXARC version 2.4
  133. -----------------------------
  134.  
  135. Performance for extracting dynamic  Lempel-Zev  files  has  been  improved.
  136. Files  which  are  identified  as  "Crunched" (with a capitol C) on the ARC
  137. verbose listing extract 15-20% faster than before.
  138.  
  139. When a "Disk full" error occurred, previous versions of PKXARC would  leave
  140. an empty or incomplete file on the disk.  PKXARC now deletes any incomplete
  141. files before aborting with a "Disk full" error.
  142.  
  143.  
  144. Changes in PKXARC version 2.5
  145. -----------------------------
  146.  
  147. The ability to extract specific files was added.  PKXARC can now be  passed
  148. the  specific names of files to be extracted from an ARChive on the command
  149. line.
  150.  
  151.  
  152. Changes in PKXARC version 2.6
  153. -----------------------------
  154.  
  155. Extraction performance for all compression  types  has  been  significantly
  156. improved  over  PKXARC  version  2.5.   Files  that are crunched with older
  157. versions of ARC (pre 5.x) extract 5% faster.  Squeezed  files  extract  15%
  158. faster.   Files that are Crunched with ARC 5.x extract 20% faster.
  159. PKXARC   FAST!  Archive Extract Utility  Version 3.0  4-05-86   by Phil Katz
  160. Page 4
  161.  
  162.  
  163. Changes in PKXARC version 2.7
  164. -----------------------------
  165.  
  166. Extraction  performance  of Squeezed files has been improved more than 60%.
  167. PKXARC version 2.7 can extract a Squeezed file more than 8 times as fast as
  168. ARC 5.1.
  169.  
  170. The message displayed when a file is being extracted has been  enhanced  to
  171. indicate the compression method used to store the file.
  172.  
  173. Message            Meaning
  174. -------            -------
  175. Extracting    The file was Stored.
  176. un-Packing    The file was Packed with non-repeat packing.
  177. uncrunching    The file was crunched with old sytle Lempel-Zev compression.
  178. unCrunching    The file was Crunched with Dynamic Lempel-Zev compression.
  179. unSqueezing    The file was Squeezed with Huffman encoding.
  180.  
  181.  
  182. Changes in PKXARC version 3.0
  183. -----------------------------
  184. The following functions have been added to PKXARC version 3.0:
  185.  
  186. Extraction of files to the console or printer.
  187. The ability to display a verbose ARChive listing.
  188. PKXARC   FAST!  Archive Extract Utility  Version 3.0  4-05-86   by Phil Katz
  189. Page 5
  190.  
  191.  
  192. General
  193. -------
  194.  
  195. PKXARC   will   run  on  any  IBM  PC/XT/AT/RT/jr/Portable/Lap-Top  or  DOS 
  196. compatible whatever running PC/MS-DOS 2.0 or higher.
  197.  
  198. IBM is a registered trademark of the International Business Machine
  199. Corporation.
  200. MS-DOS is a registered trademark of Microsoft Inc.
  201.  
  202.  
  203. If you have any questions or comments about PKXARC send them to:
  204.  
  205. Phil Katz
  206. EXEC-PC MULTI-USER IBBS
  207. Milwaukee, WI.
  208. (modem) (414) 964-5160.
  209.  
  210.  
  211. License
  212. -------
  213.  
  214. Copyright (C) 1986 Phil Katz, All Rights Reserved
  215.  
  216. You are free to use, copy and distribute PKXARC providing that:
  217.  
  218.     NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION.
  219.  
  220.     IT IS NOT MODIFIED IN ANY WAY.
  221.  
  222. This program is provided AS IS without any warranty, expressed or  implied,
  223. including but not limited to fitfulness for a particular purpose.
  224.  
  225. If you find PKXARC fast, easy, and convenient to use, a monetary
  226. contribution would be appreciated.  Send contributions to:
  227.  
  228. Phil Katz
  229. 7032 Ardara Avenue
  230. Glendale, WI 53209
  231.